.\" $Id$
.TH BW_UNIX 8 "$Date$" "(c)1994-2000 Larry McVoy and Carl Staelin" "LMBENCH"
.SH NAME
bw_unix \- UNIX pipe bandwidth
.SH SYNOPSIS
.B bw_unix
[
.I "-P <parallelism>"
]
[
.I "-W <warmups>"
]
[
.I "-N <repetitions>"
]
.I size
.SH DESCRIPTION
.B bw_unix
creates a pipe and forks a child process which keeps writing
data to the pipe as fast as it can.  The benchmark measures
how fast the parent process can 
.I read 
the data in
.IR size -byte
chunks from the pipe. Nothing is done with the data in either
the parent (reader) or child (writer) processes.
.LP
The 
.I size
specification may end with ``k'' or ``m'' to mean
kilobytes (* 1024) or megabytes (* 1024 * 1024).
.SH OUTPUT
Output format is \f(CB"%0.2f %.2f\\n", megabytes, megabytes_per_second\fP, i.e.,
.sp
.ft CB
8.00 25.33
.ft
.SH "MEMORY UTILIZATION"
This benchmark should move approximately the reported amount of memory.
.SH ACKNOWLEDGEMENT
Funding for the development of
this tool was provided by Sun Microsystems Computer Corporation.
.SH "SEE ALSO"
lmbench(8).
.SH "AUTHOR"
Carl Staelin and Larry McVoy
.PP
Comments, suggestions, and bug reports are always welcome.
